home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor2 / istk.doc < prev    next >
Internet Message Format  |  1995-03-31  |  5KB
  1. Date: January 10, 1992 
  2.  
  3. ISTK -  Directory 
  4. Programmable Interactive Stack 
  5. Copyright 1992 
  6. Brian Maguire 
  7. All Rights Reserved 
  8.  
  9. úÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ 
  10. 3 Mini-instructions: Program, List, BSTK.  -jkh- 3 
  11. àÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄù 
  12.  
  13. DISCLAIMERS 
  14.  
  15. ISTK and this manual are presented without warranties, expressed 
  16. or implied.  The author makes no guarantee as to the fitness of 
  17. this software. 
  18.  
  19. ISTK can be copied freely provided the software, including this 
  20. manual, is copied in its entirety.  The user cannot be charged, 
  21. in whole or in part, except for the cost of reproduction.  No 
  22. part of this package may be used for commercial purposes without 
  23. written permission from the author. 
  24.  
  25.  
  26.  
  27. ACKNOWLEDGEMENTS 
  28.  
  29. Special thanks to Bill Quinlan for giving me the idea to write 
  30. these programs. 
  31.  
  32.  
  33. SUMMARY 
  34.  
  35. The programs contained in the directory ISTK allows the user to 
  36. customize the interactive stack to some degree.  Three options 
  37. are available.  The user can add custom menu labels to the 
  38. existing menu, the top level on the display and the level pointed 
  39. to by the cursor can be programmably changed while in the 
  40. interactive stack, and the same two parameters can be initialized 
  41. before entering the interactive stack. 
  42.  
  43. BSTK, the main program, accepts a program and a list as input. 
  44. The program on level two is run after the interactive stack 
  45. environment is setup and before control is given to the user. 
  46. This allows the initial parameters to be changed using the 
  47. program ISTO.  The list on level one is added to the existing 
  48. menu. 
  49.  
  50. IRCL and ISTO are designed to be used only when the interactive 
  51. stack environment has been set up.  IRCL recalls the stack level 
  52. pointed to by the cursor and the level displayed on the top line. 
  53. Likewise, ISTO stores new values in these respective parameters. 
  54.  
  55.  
  56. BSTK 
  57. Programmable interactive stack 
  58.  
  59. Input                                       Output 
  60. -----                                       ------ 
  61. 2: Program (Initialization program)         Enters the interactive 
  62. 1: List (menu list)                         stack. 
  63.  
  64.  
  65. IRCL 
  66. Recall interactive stack parameters 
  67.  
  68. Input                    Output 
  69. -----                    ------ 
  70.                          2: Real number (Cursor stack level) 
  71. None                     1: Real number (Top stack level on display) 
  72.  
  73.  
  74. ISTO 
  75. Store interactive stack parameters 
  76.  
  77. Input                                            Output 
  78. -----                                            ------ 
  79. 2: Real number (Cursor stack level) 
  80. 1: Real number (Top stack level on display)      None 
  81.  
  82.  
  83. In addition to the three main programs, an example is included in 
  84. this directory.  The variable { FILE GOTO SORT$ SRCH$ STR->OB } 
  85. create a simple data browser that makes use of the interactive 
  86. stack.  I tried to write as much of this example in user RPL as I 
  87. could so most anyone could follow it.    Some of the techniques 
  88. used in this example can be used in many other applications. 
  89.  
  90. The main program is FILE.  It take a list of strings and explodes 
  91. them on the stack.  Then, using BSTK and ISTO, the cursor is 
  92. moved to the top stack level and three new menu keys are added. 
  93.  
  94. [GOTO] 
  95. Prompts the user for a stack level to jump to (something that HP 
  96. forgot to include), 
  97.  
  98. [SORT] 
  99. Sorts the strings on the stack in ascending order 
  100.  
  101. [FIND] 
  102. Prompts the user for a search string and searches the stack for a 
  103. match.  This search starts at the stack level pointed to by the 
  104. cursor and ends at level one.  This allows the user to perform a 
  105. search on selected levels of the stack. 
  106.  
  107. The two sub-programs that are written in system RPL can also be 
  108. used as stand alone programs. 
  109.  
  110. SORT$ 
  111. Sorts n strings on the stack 
  112.  
  113. Input                        Output 
  114. -----                        ------ 
  115. n:   String                  n:   String 
  116. ...  ...                     ...  ... 
  117. ...  String                  ...  String 
  118. 1:   Real number             1:   Real number 
  119.  
  120.  
  121. STR->OB 
  122. Convert a string into an object and returns the object and its 
  123. type number.  If the conversion would result in an "Invalid 
  124. Syntax" error the original string and -1 is returned. 
  125.  
  126. Input                        Output 
  127. -----                        ------ 
  128.                              2:  Object 
  129. 1: String                    1:  Real number 
  130.  
  131.  
  132.  
  133. Enjoy, 
  134.  
  135. Brian Maguire 
  136. 139 Kingsbury 
  137. Dearborn, MI 48128 
  138.